Release 10.1A: OpenEdge Development:
Java Open Clients

ProDataObject class

OpenEdge provides a Java class, com.progress.open4gl.ProDataObject, that maps to a row (record) in a Progress 4GL temp-table. The ProDataObject class extends the Java SDO DataObject class. It maps to an 4GL temp-table row within a ProDataSet. (A ProDataObject list maps to the entire 4GL temp-table). A ProDataObject holds its actual data as a set of column properties, where each Property object maps to a column (field) of the temp-table. Java SDO DataObject and extended ProDataObject access methods allow the client to get the Property object values (column data).

In the 4GL, fields in a temp-table can be defined with an extent value that creates a one-dimensional array of the specified data type, with the number of elements specified by the extent. JDBC ResultSet objects (also supported to map temp-table parameters) do not support arrays as columns for temp-table parameters. But in a Java SDO DataObject, a property's type (specified by a Type object) can be many-valued and this can be mapped to an array field.

For more information on the Java SDO Property and Type interfaces, see the "Using Java SDO classes to access Property meta data" section.

The com.progress.open4gl.ProDataObject class provides no constructor, because it is created by the ProDataGraph.createProDataObject() factory method (see the "ProDataGraph class" section). It does provide the following inherited and extended methods. Among these include methods to get and set the values of column properties according to the Java data type. To identify the Java data type that matches the Progress 4GL data type of a corresponding temp-table field, see the data type mappings in Table 5–3. If you do not already know the 4GL data type of a mapped column property, you can identify it using the getProType() method of the corresponding ProDataObjectMetaData object. For more information, see the "ProDataObjectMetaData class" section.